docs: gtk_file_chooser_get_filename() returns absolute paths
authorDavid King <amigadave@amigadave.com>
Thu, 22 Nov 2012 21:15:06 +0000 (21:15 +0000)
committerDavid King <amigadave@amigadave.com>
Sat, 24 Nov 2012 19:58:10 +0000 (19:58 +0000)
The documentation for gtk_file_chooser_get_filenames() states that the
returned filenames are absolute paths, and uses g_file_get_path() to
construct the filename. The same function is used to construct the
filename in gtk_file_chooser_get_filename(), so it should also return
absolute paths.

https://bugzilla.gnome.org/show_bug.cgi?id=371034

gtk/gtkfilechooser.c

index df794e2ae1e3d23183d4737118d0c9b3f6cfda51..8e2d64da4c87e8e2d37b5a97f921d028a3c0cf1d 100644 (file)
@@ -1032,8 +1032,9 @@ gtk_file_chooser_get_create_folders (GtkFileChooser *chooser)
  * @chooser: a #GtkFileChooser
  * 
  * Gets the filename for the currently selected file in
- * the file selector. If multiple files are selected,
- * one of the filenames will be returned at random.
+ * the file selector. The filename is returned as an absolute path. If
+ * multiple files are selected, one of the filenames will be returned at
+ * random.
  *
  * If the file chooser is in folder mode, this function returns the selected
  * folder.